═══ 1. Installation ═══ To install PM Patrol, run INSTALL.CMD from the distribution diskette. This will install all necessary files and create a subdirectory called PMP. The installation procedure also creates the PM Patrol desktop folder. You may move this into another folder if you wish. To have PM Patrol start at system bootup, create a 'Shadow' copy of the PM Patrol icon in the PM Patrol folder and specify the 'Startup' folder as the target folder. Refer to the OS/2 Workplace Shell user guide for any additional help. PM Patrol will not utilize Theseus until Theseus is installed. If the 'Theseus RAM' and 'Theseus Swap' check box in the 'Options' dialog in PM Patrol is greyed-out, Then Theseus is not installed correctly. PM Patrol does not require (c)SPM/2, just Version 2 of Theseus and the following Theseus files installed if Theseus is to be used: 1. THESEUS2.SYS CONFIG.SYS device driver 2. THESEUS0.DLL Accessible via LIBPATH in CONFIG.SYS Thesues comes highly recommended. It provides an enormous suite of information. It is not, however, for the average user. Note: Theseus is a OS/2 component of (c)SPM/2 offered by IBM and is available on many OS/2 BBS services including IBM's PCC BBS. ═══ 2. Registration ═══ PM Patrol is developed by WallyWare. If this proves useful and you wish to continue using PM Patrol, you can receive regular updates and support by submitting the registration form and $15.00 to: Dave Wallenberg 2210 Kingston Drive Wheaton IL, 60187 USA Compuserve ID 72702,2320 ═══ 3. Support ═══ PM Patrol is currently supported primarily via CompuServe on the "OS2BVEN" forum with the "Shareware" section. Although, many other OS2 user group BBSs are updated regularly with the latest PM Patrol versions. Feel free to leave messsages to me via my CompuServe: ID 72702,2320 Additional support for PM Patrol and other WallyWare software can be obtained by calling 708/574-0998 (extension 4626) and leaving voice mail for me. I will soon have Internet access and will be able to be reached there as well. I check all mail sources daily. ═══ 4. How do I ? ═══ This section describes how to do things in PM Patrol that may not be obvious. ═══ 4.1. Set fonts ═══ You can also select "Font" from the PM Patrol "Options" dialog and select a font for the PM Patrol main status line. Or, use the Font Pallete in the OS/2 "Setup" folder by dropping a font on the PM Patrol status line. Select "Save Settings" from the PM Patrol "Options" dialog to store changes permanently. Note: PM Patrol supports two fonts. One for the main status line. The other font is accessed through any of the listbox dialogs. The listbox font allows you to select a "Fixed Size" font for displays such as "Process Status". ═══ 4.2. Set Colors ═══ Use the "Colors" dialog. This can be accessed via the PM Patrol Setting option on the "Options" dialog. You can control both foreground and background RGB colors with this mechanism. Or, use the Color Pallete in the OS/2 "Setup" folder by dropping a color selection on the PM Patrol status line. Select "Save Settings" from the PM Patrol "Options" dialog to store changes permanently. ═══ 4.3. Move the Status line ═══ The following steps identify how to move the status line and then saving that position for future use: 1. Single click with both mouse buttons (Chord click) on the PM Patrol status line. This will enable the title bar to the status line. 2. Select the title bar and hold the mouse button while dragging the status line to the desired position. 3. Chord click the status line again (or select "Hide Controls" from the System Menu box) to hide the title bar. 4. Select "Save Settings" from the PM Patrol "Options" dialog to save the position permanently. Select "Save Settings" from the PM Patrol "Options" dialog to store changes permanently. ═══ 4.4. Obtaining (c)Theseus/2 ═══ Theseus is available on several BBSs. Make sure you get the latest version. Theseus is shipped with SPM/2 which can be puchased from IBM for OS/2 ═══ 5. Production Information ═══ This section describes what PM Patrol is and what it offers ═══ 5.1. What is It? ═══ PM Patrol is a performance and resource monitoring tool for OS/2 v2.1 and up. The display items, frequency of resource samples, and preferences are user selectable allowing complete customization. Always accessible, PM Patrol extents the OS/2 desktop by providing several utility items and system-wide control items. The goal of PM Patrol attempts to enhance the desktop and provide insight into OS/2 activities. Data sampled is capable of being recorded to the OS/2 clipboard for further review. The appearance of PM Control has maintained the attitude that the tool should be visible, yet not use valuable desktop space. As a result, the main status line is displayed at the bottom of the display (as default). ═══ 5.2. What does it do for me? ═══ PM Patrol enables you see at a glance some critical system resource items. It can also play a valuable role in software testing and performance measurements. The data can be captured for further review. Captured as text, display item data can be manipulated using tools such as Rexx, AWK, and GREP. Data from OS/2 resources sampled is highly reliable. Including support for IBM Theseus. Note: Theseus is a OS/2 component of (c)SPM/2 offered by IBM and is available on many OS/2 BBS services including IBM's PCC BBS ═══ 5.3. Why do I need it? ═══ You may desire the ability to monitor: 1. Inconspicuous display of current Date and Time 2. Elapsed time (user resettable) 3. Process, thread, semaphore, DLL, drivers, and shared memory activity 4. Process and thread load compared to other active OS/2 activities 5. Complete drive summary and detailed information 6. Disk Drives online (including network drives) 7. Free space for a selected drive (including network drives) 8. OS/2 swap activity (with support for IBM Theseus) 9. Identify system levels for OS/2 component installed 10. OS/2 memory activity (with support for IBM Theseus) 11. Active number of OS/2 processes, threads, and desktop windows 12. CPU utilization (current vs. rolling average over last 1 minute) 13. Battery status for mobile computers 14. and more Note: Theseus is a OS/2 component of (c)SPM/2 offered by IBM and is available on many OS/2 BBS services including IBM's PCC BBS PM Patrol contains a growing number of utility functions such as: 1. Robust monitoring and capture of OS/2 processes and threads 2. Sumary and detailed information of drives 3. Summary and detailed information of OS/2 configuration 4. Identify system levels for OS/2 component installed 5. Minimize all visible windows 6. Restore all minimized windows 7. System shutdown 8. Lockup system 9. Suspending power for mobile computers 10. Suspending display 11. Starting an OS/2 window session 12. Changing the size of the mouse for standard VGA displays 13. And more. ═══ 5.4. Who done it? ═══ (c)PM Patrol was developed by WallyWare. WallyWare develops OS/2 and UNIX software with absolutely no interest in DOS/Windows. Why promote a bad idea? ═══ 6. Options ═══ This section describes items in the Options dialog ═══ 6.1. Menu Bar Items ═══ This section describes menu bar items in the Options dialog. ═══ 6.1.1. Utility ═══ The Utility section provides a growing number of utility items. This section will, along with monitor items, grow extensively. Currently, there are some options that are unavailable and planned for the next release ═══ 6.1.1.1. Drives ═══ The Drives options provides the ability to switch drives that are online and you wish to monitor, format(full and fast), check, view summary and detail information for a particular drive. ═══ 6.1.1.2. Process Info ═══ The Process Info option provides the ability to monitor OS/2 internal process, thread, semaphore, shared memory, and modules that are active. Processes (PIDs) can be "killed" by selecting "Kill" from the "Action" menu. The data displayed in the Process Load is as follows: Press Escape to exit the dialog. 1. "PID": Process ID (displayed as a hex value) 2. "Thd": Number of threads in the PID 3. "SType": Session type 4. "Act" Identifies an active process with an "*" in this column. Active is defined as containing 1 or more threads in a "Running" or "Ready" state. 5. "SysTime": Amount of time PID (all threads) spends in the OS/2 kernal along with the percent of "SysTime" compared to TOTAL system-wide "SysTime". 6. "Name" Name of the executable The data displayed in the Process Status is as follows: Press Escape to exit the dialog. 1. "PID": Process ID (displayed as a hex value) 2. "PPID": Parent Process ID (displayed as a hex value) 3. "SID": Session ID (displayed as a hex value) 4. "SType": Session type 5. "Thd": Number of threads in the PID 6. "Sem" Number of semaphores used by the PID 7. "Mod" Number of modules (DLLs) used by the PID 8. "Shr" Number of shared memory references used by PID 9. "MMT" Memory Model Type (16 or 32 bit) 10. "Name" Name of the executable The data displayed in the Thread Status is for a given PID and has the following attributes: Press Escape to go back to Process Information. 1. "TID": Thread ID (displayed as a hex value) 2. "Slot": Slot ID for the TID (displayed as a hex value) 3. "Blk ID": Block identifier for a blocked TID (displayed as a hex value) 4. "Pri": Current priority for the TID. This displays both priority class along with the current priority level (display in hex) within the class. 5. "SysTime": Amount of time thread spends in the OS/2 kernal along with the percent of "SysTime" compared to TOTAL system-wide "SysTime". 6. "AppTime" Amount of time thread spends in the application along with the percentage of "AppTime" compared to TOTAL system-wide "AppTime" for all applications. This is relative to other active applications getting time slices. 7. "State": Identifies what state the thread is in; Blocked, Frozen, Running, and Ready. The data displayed in the Shared Memory Status has the following attributes: Press Escape to exit the dialog. 1. "HMem": Handle to memory allocation (displayed as a hex value) 2. "Sel": Selector to memory (displayed as a hex value) 3. "Refs": Number of references to the memory 4. "Name": Name of the memory used for obtaining addressability The data displayed in the Module Status has the following attributes: Modules include DLLs, Executables, drivers, fonts, and more. Press Escape to exit the dialog. 1. "HMod": Handle to the module (displayed as a hex value) 2. "MMT": Memory Model Type (16 or 32 bit) 3. "Refs": Number of references to the module 4. "Name": Name of the module The data displayed in the Semaphore Status has the following attributes: Press Escape to exit the dialog. 1. "Own": Owning thread of semaphore (displayed as a hex value) 2. "Indx": Index of semaphore (displayed as a hex value) 3. "Flag": Semaphore bit-mapped flags (displayed as a hex value) 4. "Refs": Number of references to semaphore by other programs 5. "Reqs": Number of requests for semaphore by other programs 6. "Name": Name of semaphore used to obtain access to semaphore by programs ═══ 6.1.1.3. Find ═══ The Find option will be available in a future release and will provide the ability to find files of various attributes along with duplicate files across multiple drives. This will be displayed in a "Container" format. ═══ 6.1.1.4. Clip Manager ═══ The Clip Manager option will be available in the next release and will provide multiple clip boards ═══ 6.1.1.5. Recorder ═══ The Recorder starts/stops the recording mechanism in PM Patrol to capture the main status line information to the OS/2 clipboard for further review ═══ 6.1.1.6. OS/2 Window ═══ The OS/2 Window options opens a new OS/2 command window ═══ 6.1.2. System ═══ The System section provides several OS/2 environmental functions ═══ 6.1.2.1. Lockup ═══ The Lockup option invokes the OS/2 "lockup" facility and forces the user to "log on" ═══ 6.1.2.2. Shutdown ═══ The Shutdown option performs a OS/2 shutdown ═══ 6.1.2.3. Sleep ═══ The Sleep option places the mobile computer (SL chips) into suspend mode. This option is accessible only when APM (Advanced Power Management) in installed. Refer to the OS/2 Installation Guide for APM details. ═══ 6.1.2.4. System Info ═══ The System Info displays 4 basic types of information: 1. OS/2 System information displays the basic configuration of OS/2. Many of the items are static and dont change while OS/2 is operating. Many of these items are modifiable in the CONFIG.SYS. Refer to OS/2 help for more detail. 2. Presentation Manager colors. These can be modified via the "Color Palette" in the OS/2 "System" folder. 3. Presentation Manager information displays items specific to PM. Many of these can be modified in the "Setup" folder of the WorkPlace Shell. 4. Hardware information includes printer, communication ports, drives, mouse and more. The Mouse Size option allows users of standard VGA to specify the size of the mouse. This is not available for SVGA, XGA, etc. ═══ 6.1.3. Settings ═══ The Settings section provides PM Patrol configuration items The Save Settings option permanently saves the current PM Patrol settings. This includes colors, font, status line position, and options settings (ie. sample frequencies, etc) The Restore Defaults option resets all PM Patrol options, colors, window position(s) and options settings to their original defaults The Reset Elapsed option resets the status line elapsed time to zero. This "elapsed" time is the amount of time since PM Patrol started or since last "Reset Elapsed". The Font option allows you to set the display font for all PM Patrol windows. This can also be accomplished by using the Font Palette in OS/2 the "System Settings" folder and dragging the font to the PM Patrol Status line. ═══ 6.1.4. Exit ═══ This option is used to end the PM Patrol program ═══ 6.1.5. Help ═══ The help menu allows quick access to PM Patrol help items including General Help for all online help items. ═══ 6.2. Options Pushbutton Items ═══ This section describes the Options dialog pushbutton items The OK button accepts changes made to any PM Patrol Status Line settings and closes the Options dialog window. If (c)Theseus Swap is enabled, there will be a slight delay while PM Patrol samples this (c)Theseus Swap data. The Cancel button resets any PM Patrol settings to their original status prior to entering the Options dialog. This allows you to temporarily change settings while the Options dialog is visible. The Suspend button freezes the Status line display until you resume the display or select OK or Cancel. The Minimize option (arrow pointing down) provides a quick mechanism for minimizing ALL visible OS/2 windows on the desktop thus removing the "clutter". The Restore option (arrow pointing up) provides a quick mechanism for restoring ALL minimized windows to the desktop. This is automatically performed when you use the PM Patrol "Shutdown" option to shutdown your OS/2 system. ═══ 6.3. Optional Items ═══ This section describes the optional items on the Options dialog The (c)Theseus RAM option enables/disables the use of (c)Theseus for determining free RAM(k) and idle RAM(k). This option is accessible only when "Memory Utilization" is selected in "Display Items". The (c)Theseus Swap option enables/disables the use of (c)Theseus for determining free Swap pages(k) in the system swapper file. This option is accessible only when "Swap Utilization" is selected in "Display Items". The Float to Top option enables/disables PM Patrol's ability to force visibility of it's windows when other windows overlay it's display. The CPU Graph option enables/disables a visually graphic display of CPU activity. This option is accessible only when "CPU Utilization" is selected in "Display Items". The 15 Min Timer option enables/disables an audible sound which occurs at each quarter hour. Use this feature to remind you of passing time. ═══ 6.4. Display Items ═══ This section describes the selectable display items. These items are described in detail under "Status Line" help. Select which items you want to be displayed on the PM Patrol Status Line. ═══ 6.5. Sample Frequencies ═══ This section describes the frequency of which PM Patrol items are sampled and refreshed on the main Status Line. The Drive Frequency controls how often (seconds) PM Patrol checks what drives are online and how much free disk space resides on each. The Swap Frequency controls how often (seconds) PM Patrol checks how large the OS/2 swapper file is. Note: If (c)Theseus Swap is enabled, this setting should not be less than 60 seconds as this function of (c)Theseus consumes 1-2 seconds for each each sample. Set this frequency to 300 seconds (5 minutes) when using (c)Theseus Swap. The RAM Frequency controls how often (seconds) PM Patrol checks free RAM. The Process Frequency controls how often (seconds) PM Patrol enumerates the number of active OS/2 processes, threads. and OS/2 windows. The Clip Size controls how much memory (k) is used to hold information when "Recording" the PM Patrol Status Line. The maximum is 64k which equates to about 10-13 minutes of data. ═══ 7. Status Line ═══ This section describes items displayed on the main PM Patrol status line ═══ 7.1. Current Date and Time ═══ Display of the current date and time updated every 1 minute ═══ 7.2. Elapsed time ═══ Display of the elaped time since PM Patrol started or since last reset found in "Settings" of the Options dialog. This is updated every minute. Note: This display item is associated with the Current Data and Time display option in the Options dialog. Unless the Current Date and Time display item is selected, the elapsed time will not display. ═══ 7.3. Keyboard Status ═══ The Keyboard Status displays the status of CapsLock, NumLock, and ScrollLock keyboard settings. ═══ 7.4. Drives Utilization ═══ The Drives online displays all disk drives accessible and then shows how much free space (MB) is available for the selected drive. To select a different drive to monitor choose one of the following methods: 1. Single clock the right mouse button on the PM Patrol Status line and then double click on the desired drive. 2. Single click on the PM Patrol Status line to get the Options dialog. Then select the "Utility" menu bar item followed by the "Drives" menu option. ═══ 7.5. Swap Utilization ═══ This display option displays the current size of the OS/2 swapper file. Optionally, if (c)Theseus Swap is enabled, this will also display the amount of free space (k) inside the swapper file. Refer to (c)Theseus documentation for details of free swapper frames for more detail on this topic. ═══ 7.6. Memory Utilization ═══ This displays the amount of free RAM (k) and the largest free block (LFB) of memory (k). Optionally, if (c)Theseus RAM is enabled, this will instead display free memory according to (c)Theseus along with the amount of memory (k) that is idle. Refer to (c)Theseus documentation for details of free memory and idle memory for more detail on this topic. ═══ 7.7. Process Status ═══ This display item show the number of OS/2 processes and threads in the system. This includes PIDs and TIDS of any state; Blocked, Running, and Runnable. Additionally, the current active number of windows on the desktop are shown. ═══ 7.8. Battery Status ═══ This item informs the user how much battery power is remaining. Note: This option is accessible only if APM is installed via OS/2 and the computer is a mobile computer capable of power management (ie 386sl+). When (and if) the battery status is unknown, PM Patrol displays a question mark in replacement of the actual percentage of power remaining. ═══ 7.9. CPU Utilization ═══ PM Patrol monitors the CPU utilization every second. If the "CPU Graph" has been enabled in the Options dialog, then a psudo-graphical display is shown in addition to the percentage. Along with the current CPU load, PM Patrol also maintains a rolling average of CPU utilization over the past 1 minute. ═══ 8. Miscellaneous ═══ This section discusses various "catch-all" items of interest ═══ 8.1. Mouse control with PM Patrol ═══ Single click the left mouse button on the PM Patrol status line to get to PM Patrol Options. Single click the right mouse button on the PM Patrol status line for quick access the PM Patrol utilities menu. Single click the left and right mouse buttons on the PM Patrol status line to display the PM Patrol title bar and system menu. This allows you to move the PM Patrol status line to a desired position. Note: Don't forget to "Save Settings" once you have positioned the PM Patrol status line where you want. ═══ 9. Caveat Utilitor! ═══ PM Patrol has been thoroughly tested amongst several configurations. When properly tuned, PM Patrol causes no system degradations. The overhead for PM Patrol is no more than 2-3 percent CPU load and only when resource sampling occurs for the Status Line. Process Status monitoring causes minor delays in the form of breif CPU spikes. These spikes are normal and can be further controlled in the PM Patrol "Configuration" for "Refresh Rates". Use "Auto Refresh" selectively. Several of the PM Patrol sampling threads run at or near "Idle" time priority - when there is little or no system activity. The PM Patrol defaults and minimum allowable setting for "Refresh Rates" protects you from system-wide degradation. Please report any problems, comments, and suggestions to my CompuServe mail box. The ID is: 72702,2320 ═══ 10. Disclaimer ═══ This product is supplied "as is", and without any warranties. WallyWare accepts no responsibility for any loss or damage; whether physical, financial, emotional, social, mental, marital, or otherwise that may result from the use of this product.